home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / relnotes / insight / ch2.z / ch2
Encoding:
Text File  |  2002-10-08  |  30.7 KB  |  592 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists supplemental information to be used in
  11.        conjunction with the installation methods documented in the
  12.        PPPPeeeerrrrssssoooonnnnaaaallll SSSSyyyysssstttteeeemmmm AAAAddddmmmmiiiinnnniiiissssttttrrrraaaattttiiiioooonnnn GGGGuuuuiiiiddddeeee and the IIIIRRRRIIIIXXXX AAAAddddmmmmiiiinnnn::::
  13.        SSSSooooffffttttwwwwaaaarrrreeee IIIInnnnssssttttaaaallllllllaaaattttiiiioooonnnn aaaannnndddd LLLLiiiicccceeeennnnssssiiiinnnngggg book.  The information
  14.        listed here is product- and release-specific; use it with
  15.        the aforementioned documents when installing this product.
  16.  
  17.  
  18.        2.1  _I_R_I_S__I_n_S_i_g_h_t__S_u_b_s_y_s_t_e_m_s
  19.  
  20.        The IRIS InSight product family includes these subsystems:
  21.  
  22.        _i_n_s_i_g_h_t._b_o_o_k_s._V_i_e_w_e_r_H_e_l_p      SGIHelp (Help System) Help
  23.                                      Book, 5.1
  24.  
  25.        _i_n_s_i_g_h_t._m_a_n._m_a_n               Online Documentation Software
  26.                                      Man Pages, 5.1
  27.  
  28.        _i_n_s_i_g_h_t._m_a_n._r_e_l_n_o_t_e_s          Online Documentation Software
  29.                                      Release Notes, 5.1
  30.  
  31.        _i_n_s_i_g_h_t._s_w._c_l_i_e_n_t             Insight (stub executable), 5.1
  32.  
  33.        _i_n_s_i_g_h_t._s_w._j_a_p_a_n_e_s_e           Online Documentation Japanese
  34.                                      Data, 5.1
  35.  
  36.        _i_n_s_i_g_h_t._s_w._s_g_i_h_e_l_p            SGIHelp (Help System), 5.1
  37.  
  38.        Help content for the IRIX Interactive Desktop(TM) is
  39.        retrieved from a variety of online books. These books are
  40.        normally contained within installable subsystems that are
  41.        denoted as: "*._b_o_o_k_s.*".
  42.  
  43.  
  44.        2.2  _I_R_I_S__I_n_S_i_g_h_t__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s
  45.  
  46.        This section lists the subsystems (and their sizes) of the
  47.        software.
  48.  
  49.        You can use the software installation instructions in the
  50.        PPPPeeeerrrrssssoooonnnnaaaallll SSSSyyyysssstttteeeemmmm AAAAddddmmmmiiiinnnniiiissssttttrrrraaaattttiiiioooonnnn GGGGuuuuiiiiddddeeee or the IIIIRRRRIIIIXXXX AAAAddddmmmmiiiinnnn::::
  51.        SSSSooooffffttttwwwwaaaarrrreeee IIIInnnnssssttttaaaallllllllaaaattttiiiioooonnnn aaaannnndddd LLLLiiiicccceeeennnnssssiiiinnnngggg book to install this
  52.        product.
  53.  
  54.        If you are installing this software for the first time, the
  55.        default subsystems are installed if you click the _I_n_s_t_a_l_l
  56.        _A_u_t_o_m_a_t_i_c_a_l_l_y button.  To install a different set of
  57.        subsystems, click the _C_u_s_t_o_m_i_z_e _I_n_s_t_a_l_l_a_t_i_o_n button and make
  58.        your new selections.  Then click the _S_t_a_r_t button to launch
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        the installation.
  75.  
  76.        Note:  The listed subsystem sizes are approximate. Refer to
  77.               the IIIIRRRRIIIIXXXX AAAAddddmmmmiiiinnnn:::: SSSSooooffffttttwwwwaaaarrrreeee IIIInnnnssssttttaaaallllllllaaaattttiiiioooonnnn aaaannnndddd LLLLiiiicccceeeennnnssssiiiinnnngggg
  78.               book for information on finding exact sizes.
  79.  
  80.        Subsystem Name                       Subsystem Size
  81.                                             (Kilobytes)
  82.        _i_n_s_i_g_h_t._b_o_o_k_s._V_i_e_w_e_r_H_e_l_p (_d_e_f_a_u_l_t)        216
  83.        _i_n_s_i_g_h_t._m_a_n._m_a_n (_d_e_f_a_u_l_t)                  28
  84.        _i_n_s_i_g_h_t._m_a_n._r_e_l_n_o_t_e_s (_d_e_f_a_u_l_t)             56
  85.        _i_n_s_i_g_h_t._s_w._c_l_i_e_n_t (_d_e_f_a_u_l_t)               112
  86.        _i_n_s_i_g_h_t._s_w._j_a_p_a_n_e_s_e                        28
  87.        _i_n_s_i_g_h_t._s_w._s_g_i_h_e_l_p (_d_e_f_a_u_l_t)              692
  88.  
  89.  
  90.  
  91.        2.3  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  92.  
  93.        All of the subsystems for IRIS InSight can be installed
  94.        using IRIX.  You do not need to use the miniroot. Refer to
  95.        the IIIIRRRRIIIIXXXX AAAAddddmmmmiiiinnnn:::: SSSSooooffffttttwwwwaaaarrrreeee IIIInnnnssssttttaaaallllllllaaaattttiiiioooonnnn aaaannnndddd LLLLiiiicccceeeennnnssssiiiinnnngggg book for
  96.        complete installation instructions.
  97.  
  98.  
  99.        2.4  _P_r_e_r_e_q_u_i_s_i_t_e_s
  100.  
  101.        Your workstation must be running IIIIRRRRIIIIXXXX 6666....5555....11117777 oooorrrr ggggrrrreeeeaaaatttteeeerrrr in
  102.        order to use this software release.
  103.  
  104.        It is required that the _i_n_s_i_g_h_t__b_a_s_e product be installed.
  105.        In particular, the _i_n_s_i_g_h_t__b_a_s_e._s_w._e_o_e subsystem.
  106.  
  107.        If you install SGIHelp (the Help system, _i_n_s_i_g_h_t._s_w._s_g_i_h_e_l_p)
  108.        then you must also install _x__e_o_e._s_w._e_o_e, _m_o_t_i_f__e_o_e._s_w._e_o_e,
  109.        _w_e_b_v_i_e_w_e_r._s_w._e_o_e, _w_e_b_s_u_p_p_o_r_t__e_o_e._s_w._l_i_b, and
  110.        _V_i_e_w_K_i_t__e_o_e._s_w._b_a_s_e for the viewer to function properly.
  111.  
  112.  
  113.        2.5  _C_o_m_p_a_t_i_b_i_l_i_t_y
  114.  
  115.        It is important to note that as of release 5.0 (shipped with
  116.        IRIX 6.5.17), the tools and processes available in the
  117.        InSight product family can no longer read the older format
  118.        of the books (pre-IRIX 6.5.17). Many of the tools
  119.        (_i_n_s_i_g_h_t_A_d_m_i_n, _s_g_i_h_e_l_p, _i_n_f_o_s_e_a_r_c_h) will produce a warning
  120.        that identifies these "older" books and indicates that they
  121.        need to be updated or converted.  Information on converting
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                                   - 3 -
  134.  
  135.  
  136.  
  137.        "older" books to the newer format is found in these release
  138.        notes.
  139.  
  140.        As of release 5.0 (shipped with IRIX 6.5.17), accessing
  141.        books that are mounted from a system on an earlier version
  142.        of IRIX (pre-IRIX 6.5.17) is not recommended as the
  143.        underlying book format of the earlier versions is not
  144.        compatible with the current (version 5.0 and beyond) tools.
  145.        The tools will flag those books as being incompatible and
  146.        will request that you perform an update or conversion.
  147.  
  148.        Conversely, you can mount the "newer" format books (IRIX
  149.        6.5.17 and beyond) on earlier versions of IRIX and they will
  150.        work, but it is not recommended as these books are now in an
  151.        HTML format (derived from XML).
  152.  
  153.        Finally, you should encounter no problems accessing
  154.        (mounting) the "newer" format books (IRIX 6.5.17 and beyond)
  155.        from/to machines on IRIX 6.5.17 (and beyond).
  156.  
  157.  
  158.  
  159.        2.6  _O_t_h_e_r__I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  160.  
  161.        Important: Please read the next sections carefully.  They
  162.                   detail installation and configuration information
  163.                   specific to this product.
  164.  
  165.        First, we define a few terms. A bbbbooooooookkkksssshhhheeeellllffff is defined as a
  166.        directory containing a set of books. By default, bookshelves
  167.        are located in:
  168.  
  169.        ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss
  170.  
  171.        To examine a sample bookshelf, look under this default path.
  172.        Most of the directories contained under this area are
  173.        defined as bookshelves. By convention, below each of those
  174.        bookshelf directories exists a subdirectory named "_b_o_o_k_s".
  175.        This subdirectory contains all available _o_n_l_i_n_e _b_o_o_k_s for
  176.        this bookshelf.  For example, examining the path:
  177.  
  178.        ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss////SSSSGGGGIIII____EEEEnnnnddddUUUUsssseeeerrrr////bbbbooooooookkkkssss////DDDDeeeesssskkkkttttoooopppp____UUUUGGGG
  179.  
  180.        SSSSGGGGIIII____EEEEnnnnddddUUUUsssseeeerrrr is the bookshelf, DDDDeeeesssskkkkttttoooopppp____UUUUGGGG is the book, and
  181.        everything under ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy is defined as
  182.        your online documentation library.
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.                                   - 4 -
  200.  
  201.  
  202.  
  203.        2.7  _C_o_n_v_e_r_t_i_n_g__O_l_d_e_r__F_o_r_m_a_t__B_o_o_k_s
  204.  
  205.  
  206.        It is important to note that as of release 5.0 (shipped with
  207.        IRIX 6.5.17), the tools and processes available in the
  208.        InSight product family can no longer read the older format
  209.        of the books (pre-IRIX 6.5.17). Many of the tools
  210.        (_i_n_s_i_g_h_t_A_d_m_i_n, _s_g_i_h_e_l_p, _i_n_f_o_s_e_a_r_c_h) will produce a warning
  211.        that identifies these "older" books and indicates that they
  212.        need to be updated or converted.  The _i_n_s_i_g_h_t_A_d_m_i_n tool
  213.        allows you to perform this conversion and is designed to
  214.        work upon the bookshelves contained within your online
  215.        documentation library.
  216.  
  217.        If you encounter warnings from the various online
  218.        documentation tools (_i_n_s_i_g_h_t_A_d_m_i_n, _s_g_i_h_e_l_p, _i_n_f_o_s_e_a_r_c_h) such
  219.        as "<book> cannot be read and needs to be converted" or
  220.        "<book> appears to be in old/unreadable format", you can use
  221.        the _i_n_s_i_g_h_t_A_d_m_i_n tool to perform the conversion for you.
  222.  
  223.  
  224.        Note:  You can find which books require conversion using
  225.               _i_n_s_i_g_h_t_A_d_m_i_n.  Within a shell window, as root, type:
  226.  
  227.               iiiinnnnssssiiiigggghhhhttttAAAAddddmmmmiiiinnnn ----vvvv
  228.  
  229.               Look for those books (and bookshelves) that report
  230.               the aforementioned warning message.
  231.  
  232.        _i_n_s_i_g_h_t_A_d_m_i_n has two options related to this function.  The
  233.        ----cccc option instructs _i_n_s_i_g_h_t_A_d_m_i_n to convert any books on the
  234.        specified bookshelf that cannot be read (old format books).
  235.        By default, this conversion is accomplished by sending the
  236.        book through a local filtering process.
  237.  
  238.        Optionally, downloading the "packaged" book(s) from the
  239.        SSSSiiiilllliiiiccccoooonnnn GGGGrrrraaaapppphhhhiiiiccccssss TTTTeeeecccchhhhnnnniiiiccccaaaallll PPPPuuuubbbblllliiiiccccaaaattttiiiioooonnnnssss LLLLiiiibbbbrrrraaaarrrryyyy website
  240.        (http://techpubs.sgi.com) can be initiated if the ----dddd option
  241.        is specified. If (for some reason) the download fails, then
  242.        the local filtering process is still attempted upon the
  243.        book(s) that encountered problems.
  244.  
  245.        The _g_e_t_u_r_l(_1) command is used in conjunction with the ----dddd
  246.        option. Note that if you utilize a proxy server, the
  247.        communication library _g_e_t_u_r_l(_1) employs may need to be
  248.        configured properly. This can be done through the _w_e_b_c_o_n_t_r_o_l
  249.        panel. See the man page for _w_e_b_c_o_n_t_r_o_l(_1) for details.
  250.  
  251.        Note that this conversion stage may take some time and
  252.        should be used with caution. The amount of time varies with
  253.        the number and size of the book(s) that need to be
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.                                   - 5 -
  266.  
  267.  
  268.  
  269.        converted. The local filtering phase could take from 1 to 3
  270.        minutes per book.  A system administrator may wish to
  271.        perform this operation during off-peak system times, perhaps
  272.        utilizing _c_r_o_n(_1_M) to schedule the command (or another such
  273.        job scheduler).
  274.  
  275.        The following are examples of using _i_n_s_i_g_h_t_A_d_m_i_n to perform
  276.        the conversion procedure.
  277.  
  278.           +o This example converts any old format books on the
  279.             SSSSGGGGIIII____EEEEnnnnddddUUUUsssseeeerrrr bookshelf using the local filtering process
  280.             only:
  281.  
  282.               ////uuuussssrrrr////ssssbbbbiiiinnnn////iiiinnnnssssiiiigggghhhhttttAAAAddddmmmmiiiinnnn ----cccc ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss////SSSSGGGGIIII____EEEEnnnnddddUUUUsssseeeerrrr
  283.  
  284.           +o This example converts any old format books on the
  285.             SSSSGGGGIIII____EEEEnnnnddddUUUUsssseeeerrrr bookshelf by first attempting to download
  286.             the converted book(s) from techpubs.sgi.com.  If (for
  287.             some reason) that operation fails, it will use the
  288.             local filtering process:
  289.  
  290.               ////uuuussssrrrr////ssssbbbbiiiinnnn////iiiinnnnssssiiiigggghhhhttttAAAAddddmmmmiiiinnnn ----cccc ----dddd ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss////SSSSGGGGIIII____EEEEnnnnddddUUUUsssseeeerrrr
  291.  
  292.           +o This example converts any old format books found on aaaallllllll
  293.             bookshelves in your online documentation library (using
  294.             the default path:
  295.             ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss). It first
  296.             attempts to download the converted book(s) from
  297.             techpubs.sgi.com.  If (for some reason) that operation
  298.             fails, it will use the local filtering process.  This
  299.             command might be suitable for using with _c_r_o_n(_1_M), if
  300.             the administrator so chooses:
  301.  
  302.               ////uuuussssrrrr////ssssbbbbiiiinnnn////iiiinnnnssssiiiigggghhhhttttAAAAddddmmmmiiiinnnn ----cccc ----dddd
  303.  
  304.        2.8  _R_e_a_d_i_n_g__O_n_l_i_n_e__B_o_o_k_s
  305.  
  306.        You can use the _i_n_f_o_s_e_a_r_c_h tool to access your online
  307.        documentation (including books, man pages and release
  308.        notes).  _i_n_f_o_s_e_a_r_c_h works through a web server and can be
  309.        accessed using any web browser. See the _i_n_f_o_s_e_a_r_c_h(_1) man
  310.        page or release notes for details on that product.
  311.  
  312.        Help content is displayed and accessed via the _s_g_i_h_e_l_p
  313.        application.
  314.  
  315.        Online books can be read directly through the IRIX
  316.        Interactive Desktop(TM) file manager. To access a list of
  317.        available bookshelves:
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.                                   - 6 -
  332.  
  333.  
  334.  
  335.          a.  From the Toolchest, click the menu items:
  336.  
  337.              DDDDeeeesssskkkkttttoooopppp ---->>>> AAAAcccccccceeeessssssss FFFFiiiilllleeeessss ---->>>> IIIInnnn mmmmyyyy HHHHoooommmmeeee DDDDiiiirrrreeeeccccttttoooorrrryyyy
  338.  
  339.          b.  Change the path to reflect the following (default)
  340.              location:
  341.  
  342.              ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss
  343.  
  344.          c.  Single-click the file iiiinnnnddddeeeexxxx....hhhhttttmmmmllll to select it, then
  345.              click the magnifying glass icon found on the left hand
  346.              side of the window.  The rendered contents of the HTML
  347.              file will appear in the Preview window below the file
  348.              list.
  349.  
  350.        Finally, you can also access the online books from the file
  351.        system using any web browser. For example, to access a list
  352.        of available bookshelves, in a shell window type the
  353.        following:
  354.  
  355.        nnnneeeettttssssccccaaaappppeeee ffffiiiilllleeee::::////////////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss////iiiinnnnddddeeeexxxx....hhhhttttmmmmllll
  356.  
  357.        2.9  _I_n_s_t_a_l_l_a_t_i_o_n__O_p_t_i_o_n_s__f_o_r__O_n_l_i_n_e__B_o_o_k_s
  358.  
  359.        You can install the online books in various configurations:
  360.  
  361.           +o Local Books
  362.  
  363.           +o Remote (mounted) Books
  364.  
  365.           +o Access Books from a CD-ROM
  366.  
  367.        2.9.1  _L_o_c_a_l__B_o_o_k_s
  368.  
  369.        The default installation configuration is to install the
  370.        online documentation library on a single system.  If you
  371.        have the disk space, this is the ideal configuration since
  372.        it gives the tools the fastest access to the book data.
  373.  
  374.        See the Release Notes for products that contain books to
  375.        find out the disk space requirements for each book.
  376.  
  377.  
  378.        2.9.2  _R_e_m_o_t_e__(_m_o_u_n_t_e_d_)__B_o_o_k_s
  379.  
  380.        If several machines plan on sharing all the books and help
  381.        files via NFS mounts then this is the configuration of
  382.        choice.
  383.  
  384.        Note:  If you have the online books (library) installed on
  385.               your disk but wish to mount the books from a remote
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.                                   - 7 -
  398.  
  399.  
  400.  
  401.               machine, you should remove all the current books
  402.               (with the IRIX command _v_e_r_s_i_o_n_s _r_e_m_o_v_e) from your
  403.               system and remove any remaining files in
  404.               /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y before performing the
  405.               mount command described below.
  406.  
  407.        To install the online books on a remote server and access
  408.        the information from a local client system, follow these
  409.        steps:
  410.  
  411.          1.  On the server:
  412.  
  413.                a.  Install the _i_n_s_i_g_h_t, _i_n_s_i_g_h_t__b_a_s_e and
  414.                    (optionally) the _i_n_f_o_s_e_a_r_c_h and _s_g_s_e_a_r_c_h product
  415.                    images and all books (you may also wish to
  416.                    install all man pages and release notes for
  417.                    access through the _i_n_f_o_s_e_a_r_c_h server extensions;
  418.                    see the _i_n_f_o_s_e_a_r_c_h for details).
  419.  
  420.                    IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll iiiinnnnssssiiiigggghhhhtttt iiiinnnnssssiiiigggghhhhtttt____bbbbaaaasssseeee iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh ssssggggsssseeeeaaaarrrrcccchhhh ****....bbbbooooooookkkkssss....****
  421.  
  422.                b.  Export the /_u_s_r/_s_h_a_r_e directory using the System
  423.                    Manager.
  424.  
  425.          2.  On the client:
  426.  
  427.                a.  Install the _i_n_s_i_g_h_t._s_w._s_g_i_h_e_l_p,
  428.                    _i_n_s_i_g_h_t__b_a_s_e._s_w._e_o_e, _i_n_f_o_s_e_a_r_c_h._s_w._b_a_s_e and
  429.                    _i_n_f_o_s_e_a_r_c_h._s_w._c_l_i_e_n_t subsystems.
  430.  
  431.                    IIIInnnnsssstttt>>>> kkkkeeeeeeeepppp iiiinnnnssssiiiigggghhhhtttt iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh
  432.                    IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll iiiinnnnssssiiiigggghhhhtttt....sssswwww....ssssggggiiiihhhheeeellllpppp iiiinnnnssssiiiigggghhhhtttt____bbbbaaaasssseeee....sssswwww....eeeeooooeeee iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh....sssswwww....bbbbaaaasssseeee iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh....sssswwww....cccclllliiiieeeennnntttt
  433.  
  434.                b.  Mount <_s_e_r_v_e_r>:/_u_s_r/_s_h_a_r_e on /_u_s_r/_s_h_a_r_e.
  435.  
  436.                    mmmmoooouuuunnnntttt <<<<sssseeeerrrrvvvveeeerrrr>>>>::::////uuuussssrrrr////sssshhhhaaaarrrreeee ////uuuussssrrrr////sssshhhhaaaarrrreeee
  437.  
  438.  
  439.        2.9.3  _C_l_i_e_n_t__A_c_c_e_s_s_i_n_g__B_o_o_k_s__f_r_o_m__a__C_D_-_R_O_M
  440.  
  441.        Note:  If you have the online books installed on your disk
  442.               but wish to mount the books from the CD-ROM, you
  443.               should remove all the current online books (with the
  444.               IRIX command _v_e_r_s_i_o_n_s _r_e_m_o_v_e) from your system and
  445.               remove any remaining files in
  446.               /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y before creating the
  447.               symbolic link described in step 2.
  448.  
  449.        If you wish to use the online books from the CD-ROM and
  450.        access the information from a local system, follow these
  451.        steps:
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.                                   - 8 -
  464.  
  465.  
  466.  
  467.          1.  On the system with the CD-ROM drive, insert the CD
  468.              that contains the online books into the CD-ROM drive.
  469.  
  470.              If the drive is not mounted, use the System Manager to
  471.              mount the drive.  The most common mount point is
  472.              /_C_D_R_O_M.
  473.  
  474.              If the drive is mounted correctly, you should be able
  475.              to change directories to /_C_D_R_O_M and see the directory
  476.              containing the online books on the CD (for example, a
  477.              directory called "insight"):
  478.  
  479.              ccccdddd ////CCCCDDDDRRRROOOOMMMM
  480.              llllssss
  481.  
  482.          2.  As root, create a symbolic link from
  483.              /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y/_S_G_I__b_o_o_k_s_h_e_l_v_e_s to the CD
  484.              mount point for the _i_n_s_i_g_h_t directory.  You may need
  485.              to create the directory /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y if
  486.              it doesn't exist.
  487.  
  488.              mmmmkkkkddddiiiirrrr ----pppp ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy
  489.              llllnnnn ----ssss ////CCCCDDDDRRRROOOOMMMM////iiiinnnnssssiiiigggghhhhtttt////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss
  490.                    ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss
  491.  
  492.          3.  As root create a symbolic link from /_u_s_r/_s_h_a_r_e/_h_e_l_p to
  493.              the CD mount point for the _h_e_l_p directory (if one
  494.              exists).
  495.  
  496.              llllnnnn ----ssss ////CCCCDDDDRRRROOOOMMMM////hhhheeeellllpppp ////uuuussssrrrr////sssshhhhaaaarrrreeee////hhhheeeellllpppp
  497.  
  498.              If you are sharing this CD-ROM mount point with other
  499.              users on your network, export the root (``/'')
  500.              directory and the /_C_D_R_O_M directory using the System
  501.              Manager.
  502.  
  503.          4.  On each client:
  504.  
  505.                a.  Install the _i_n_s_i_g_h_t._s_w._s_g_i_h_e_l_p,
  506.                    _i_n_s_i_g_h_t__b_a_s_e._s_w._e_o_e, _i_n_f_o_s_e_a_r_c_h._s_w._b_a_s_e and
  507.                    _i_n_f_o_s_e_a_r_c_h._s_w._c_l_i_e_n_t subsystems.
  508.  
  509.                    IIIInnnnsssstttt>>>> kkkkeeeeeeeepppp iiiinnnnssssiiiigggghhhhtttt iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh
  510.                    IIIInnnnsssstttt>>>> iiiinnnnssssttttaaaallllllll iiiinnnnssssiiiigggghhhhtttt....sssswwww....ssssggggiiiihhhheeeellllpppp iiiinnnnssssiiiigggghhhhtttt____bbbbaaaasssseeee....sssswwww....eeeeooooeeee iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh....sssswwww....bbbbaaaasssseeee iiiinnnnffffoooosssseeeeaaaarrrrcccchhhh....sssswwww....cccclllliiiieeeennnntttt
  511.  
  512.  
  513.                b.  If you are mounting the CD-ROM from a remote
  514.                    system, as root, mount <_c_d-
  515.                    _s_e_r_v_e_r>:/_C_D_R_O_M/_i_n_s_i_g_h_t/_S_G_I__b_o_o_k_s_h_e_l_v_e_s on
  516.                    /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y/_S_G_I__b_o_o_k_s_h_e_l_v_e_s. You
  517.                    may need to create the directory
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.                                   - 9 -
  530.  
  531.  
  532.  
  533.                    /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y/_S_G_I__b_o_o_k_s_h_e_l_v_e_s if it
  534.                    doesn't exist.
  535.  
  536.                    mmmmkkkkddddiiiirrrr ----pppp ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss
  537.                    mmmmoooouuuunnnntttt <<<<ccccdddd----sssseeeerrrrvvvveeeerrrr>>>>::::////CCCCDDDDRRRROOOOMMMM////iiiinnnnssssiiiigggghhhhtttt////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss \\\\
  538.                    ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss
  539.  
  540.                c.  If you are mounting the CD-ROM from a remote
  541.                    system, mount <_c_d-_s_e_r_v_e_r>:/_C_D_R_O_M/_h_e_l_p on
  542.                    /_u_s_r/_s_h_a_r_e/_h_e_l_p. You may need to create the
  543.                    directory /_u_s_r/_s_h_a_r_e/_h_e_l_p if it doesn't exist.
  544.  
  545.                    mmmmkkkkddddiiiirrrr ----pppp ////uuuussssrrrr////sssshhhhaaaarrrreeee////hhhheeeellllpppp
  546.                    mmmmoooouuuunnnntttt <<<<ccccdddd----sssseeeerrrrvvvveeeerrrr>>>>::::////CCCCDDDDRRRROOOOMMMM////hhhheeeellllpppp ////uuuussssrrrr////sssshhhhaaaarrrreeee////hhhheeeellllpppp
  547.  
  548.  
  549.  
  550.        2.10  _E_x_e_c_u_t_i_o_n__A_f_t_e_r__I_n_s_t_a_l_l_a_t_i_o_n
  551.  
  552.        Refer to the section "Reading Online Books".
  553.  
  554.  
  555.        2.11  _M_a_i_n_t_e_n_a_n_c_e__A_f_t_e_r__R_e_m_o_v_i_n_g__B_o_o_k_s
  556.  
  557.        The installation of books causes several commands to be
  558.        executed during the exitop phase to create a library level
  559.        index for each bookshelf.  If you remove books using the
  560.        _v_e_r_s_i_o_n_s _r_e_m_o_v_e command, the books are removed and the
  561.        library level index is updated _a_u_t_o_m_a_t_i_c_a_l_l_y by a "removeop"
  562.        command (_i_n_s_i_g_h_t_A_d_m_i_n).
  563.  
  564.        If for any reason you believe the tools do not reflect the
  565.        books installed on your system (in particular, this could
  566.        happen if a book or books have been removed by a means other
  567.        than using the _v_e_r_s_i_o_n_s _r_e_m_o_v_e command), you can invoke the
  568.        _i_n_s_i_g_h_t_A_d_m_i_n tool on a specific bookshelf (or all
  569.        bookshelves) to correct the situation.  See the man page for
  570.        _i_n_s_i_g_h_t_A_d_m_i_n for more details.
  571.  
  572.        ssssuuuu
  573.        iiiinnnnssssiiiigggghhhhttttAAAAddddmmmmiiiinnnn ----vvvv
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.